package com.blog.cmrpersonalblog.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.blog.cmrpersonalblog.entity.ArticleTag;
import com.blog.cmrpersonalblog.entity.ArticleTagRelation;

import java.util.List;

/**
 * 文章标签关联服务接口
 */
public interface ArticleTagRelationService extends IService<ArticleTagRelation> {

    /**
     * 根据文章ID查询标签列表
     * @param articleId 文章ID
     * @return 标签列表
     */
    List<ArticleTag> getTagsByArticleId(Long articleId);

    /**
     * 根据标签ID查询文章ID列表
     * @param tagId 标签ID
     * @return 文章ID列表
     */
    List<Long> getArticleIdsByTagId(Long tagId);

    /**
     * 根据标签ID列表查询文章ID列表
     * @param tagIds 标签ID列表
     * @return 文章ID列表
     */
    List<Long> getArticleIdsByTagIds(List<Long> tagIds);

    /**
     * 为文章设置标签
     * @param articleId 文章ID
     * @param tagIds 标签ID列表
     * @return 是否成功
     */
    boolean setArticleTags(Long articleId, List<Long> tagIds);

    /**
     * 为文章添加标签
     * @param articleId 文章ID
     * @param tagIds 标签ID列表
     * @return 是否成功
     */
    boolean addArticleTags(Long articleId, List<Long> tagIds);

    /**
     * 删除文章的指定标签
     * @param articleId 文章ID
     * @param tagIds 标签ID列表
     * @return 是否成功
     */
    boolean removeArticleTags(Long articleId, List<Long> tagIds);

    /**
     * 删除文章的所有标签
     * @param articleId 文章ID
     * @return 是否成功
     */
    boolean removeAllArticleTags(Long articleId);

    /**
     * 删除标签的所有文章关联
     * @param tagId 标签ID
     * @return 是否成功
     */
    boolean removeAllTagArticles(Long tagId);

    /**
     * 统计文章的标签数量
     * @param articleId 文章ID
     * @return 标签数量
     */
    int countTagsByArticleId(Long articleId);

    /**
     * 统计标签关联的文章数量
     * @param tagId 标签ID
     * @return 文章数量
     */
    int countArticlesByTagId(Long tagId);

    /**
     * 查询热门标签
     * @param limit 限制数量
     * @return 标签列表
     */
    List<ArticleTag> getHotTags(int limit);

    /**
     * 查询文章的标签ID列表
     * @param articleId 文章ID
     * @return 标签ID列表
     */
    List<Long> getTagIdsByArticleId(Long articleId);

    /**
     * 更新标签的使用次数
     * @param tagId 标签ID
     * @param increment 增量（可以为负数）
     * @return 是否成功
     */
    boolean updateTagUseCount(Long tagId, int increment);

    /**
     * 同步文章的标签数量到article表
     * @param articleId 文章ID
     * @return 是否成功
     */
    boolean syncArticleTagCount(Long articleId);

    /**
     * 批量同步所有文章的标签数量
     * @return 成功数量
     */
    int syncAllArticleTagCounts();

    /**
     * 重新计算标签的使用次数
     * @param tagId 标签ID
     * @return 是否成功
     */
    boolean recalculateTagUseCount(Long tagId);

    /**
     * 批量重新计算所有标签的使用次数
     * @return 成功数量
     */
    int recalculateAllTagUseCounts();
}